home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: The Best of Public Domain / Best of Public Domain, The Nr.37 (19xx)(Garfield, Andi)(DE).zip / Best of Public Domain, The Nr.37 (19xx)(Garfield, Andi)(DE).adf / docs < prev    next >
Text File  |  1989-11-20  |  20KB  |  419 lines

  1. THE BUTCHER
  2. -----------
  3.  
  4. Project Menu
  5. ------------
  6. Ask Mode:
  7.      320 x 200     1 - 5 bit-planes
  8.      320 x 400     1 - 5 bit-planes interlaced
  9.      640 x 200     1 - 4 bit-planes
  10.      640 x 400     1 - 4 bit-planes
  11.      320 x 200     Hold and Modify  (6 bit-planes)
  12.  
  13. Tools Menu
  14. ----------
  15. Undo:
  16.      You can reverse many of the commands in this program by
  17.      selecting UNDO
  18.  
  19. Draw:
  20.      A few primitive drawing tools are included in a small
  21.      window which you can move around the screen. Upon
  22.      selection of one of the five commands, (Filled Box,
  23.      Hollow Box, Lines, Draw, Fill) the window will disappear
  24.      and you can draw with the selected tool using the current
  25.      color. To recall the draw window, press the right mouse
  26.      button. The last thing which you did can be cancelled
  27.      by pressing the UNDO button.
  28.  
  29.      On choosing "Pick" the window will also disappear and all
  30.      pixels of the current color will flash in red. To stop
  31.      the flashing, press the left mouse button. You can flash
  32.      any of the colors by positioning the crosshairs over a
  33.      pixel of the desired color and again pressing the left
  34.      mouse button. You can continue to do this until you
  35.      press the right button. The window will return and the 
  36.      current color will be the last flashing color. This
  37.      command is used in several places in the program.
  38.  
  39. Reverse and Flip:
  40.      "Reverse" will reverse the screen horizontally. "Flip"
  41.      turns the screen upside down.
  42.  
  43. Palettes:
  44.      You can maintain three different palettes at all times.
  45.      These palettes are switchable from the menu. When you
  46.      load a picture, the picture's colormap is always loaded
  47.      into Palette One. Should you wish to apply another 
  48.      palette  to a picture, you should first copy that palette
  49.      into Palettes Two or Three before loading the picture.
  50.      Sorting by intensity is particularly effective if used
  51.      with the "Spread" command. By spreading a range of 
  52.      colors between two shades of the same hue you can produce
  53.      a shaded picture. Also, by exchanging the colors at the
  54.      light and dark ends and spreading between the ends, you
  55.      can create a negative.
  56.  
  57.      The "Copy" and "Ex" (Exchange) commands work as they do
  58.      in most palettes. With "Copy" you can not only copy colors
  59.      to other positions, but you can also copy the current
  60.      palette to another palette by pressing one of the Palette 
  61.      Selection Buttons after invoking the copy. The "Pick"
  62.      command that is also found in other parts of the program 
  63.      flashes the current color in red. You can stop the 
  64.      flashing by pressing the left mouse button. You can 
  65.      select a new current color by positioning the crosshairs 
  66.      over a pixel and again pressing the left mouse button.
  67.      This process can be repeated until the right mouse button
  68.      is pressed. The last flashing color is then the current
  69.      color.
  70.  
  71.      The "Map" command will map one palette to another palette.
  72.      Butcher will rearrange the colors of the second palette
  73.      to match more colsely the colors of the first palette.
  74.      Sometimes this match will be very good depending on the
  75.      closeness of colors in the two palettes. The mapping is
  76.      less effective if the palettes are not very close.
  77.  
  78. Process Menu
  79. ------------
  80. Edge:
  81.      The edging process of Butcher if based on a nonlinear
  82.      function which decides whethter any particular pixel is
  83.      part of an edge by examining its neighboring pixels. If
  84.      the computed variance between the tested pixel and its 
  85.      neighbors is greater than an adjustable threshold,
  86.      Butcher writes that position as part of an edge.
  87.  
  88.      You set the threshold with the proportional gadget
  89.      at the top of the window. A threshold of zero will result
  90.      in edges at all points where a pixel differs with one of
  91.      its neighbors. If this gadget is tuned to its maximum 
  92.      value, edges will be found only where pure black
  93.      (R = G = B = 0) is found next to pure white (R = G = B = 15)
  94.      Note that Butcher only notices differences in intensity,
  95.      not in color. If two very different colors have R + G + B
  96.      values which are similar, then it less likely that an 
  97.      edge will be found. Finding edges by intensity is
  98.      satisfactory in most cases.
  99.  
  100.      The pen gadgets determine the color of the contour
  101.      lines. "Light" will map the brightest color from the
  102.      palette on a background of the darkest color. "Dark" will
  103.      reverse the foreground and background colors.
  104.  
  105.      If "Color" is selected, the pen color will relate to
  106.      the actual pen color of a tested pixel. If the 
  107.      proportional gadget at the bottom of the window is tuned to
  108.      zero (completely to the left), the pen color is the actual
  109.      color of the pixel. Increasing the value of "Darkness"
  110.      will cause the program to choose darker and darker colors
  111.      from the existing palette. If possible, it will choose
  112.      colors with related hues.
  113.  
  114.      "Enhance" applies the edges to the pcture itself. If
  115.      the pen color is light, white lines will be traced around
  116.      the contours of the picture. If the pen color is dark,
  117.      black lines will be written on the edges. If "Color" is
  118.      selected, different colors from the palette will be used
  119.      on the picture.
  120.  
  121.      "Map" draws the edges on a blank background. If "Color"
  122.      is active, colors are drawn on a blank background. The
  123.      background will be as dark as possible. Mapping on a
  124.      dark background with different colors often produces
  125.      eerie effects.
  126.  
  127.      You can stop mapping a picture at any time by pressing
  128.      "Stop". "View" closes the Edge Window until you press the
  129.      right mouse button. "Restore" returns the original picture
  130.      to the screen. "Keep" closes the Edge Window and keeps 
  131.      whatever picture is currently displayed. "Cancel" closes
  132.      the window and returns the original picture to the screen.
  133.  
  134. Filter:
  135.      The filter removes isolated pixels or isolated groups
  136.      of pixels from the picture. Level 1 will remove pixels
  137.      which do not have neighboring pixels of the same color.
  138.      Levels 2 through 4 will attempt to remove larger groups of
  139.      pixels of the selected color. Isolated pixels chosen for
  140.      removal will be replaced with a neighboring color. Butcher
  141.      filters pictures by testing each set of pixels with
  142.      templates of all other colors. You can stop this process
  143.      at any time by pressing "Stop".
  144.  
  145.      You can clip the part of the screen you wish to filter
  146.      with the "Clip" command. You can pull a rectangle on the
  147.      screen which will define the section which will be
  148.      filtered. If you frame a section which is not exactly
  149.      right, you can continue to pull rectangles until you 
  150.      press the right mouse button. You can remove the clip by
  151.      pressing the "Clip" button a second time.
  152.  
  153.      You can select the filtered color by pressing one of
  154.      the color squares at the bottom of the window. Also, you
  155.      can choose a color by selecting "Pick" and pressing the
  156.      left mouse button when the crosshairs are over a pixel of
  157.      the desired color. The last color which flashes red is
  158.      the current color.
  159.  
  160.      "Filter" works particularly well on contour maps or
  161.      on pictures with only a few colors. Filter is less 
  162.      effective on areas with finely grained mixes of numerous
  163.      colors.
  164.  
  165. Mosaic:
  166.      Mosaic creates new pictures with blocks of colors. The
  167.      color for each block is a sample from the original
  168.      picture. You can adjust the pixel height of the blocks.
  169.      Butcher adjusts the width depending on the pixel aspect
  170.      ratio for the current display mode.
  171.  
  172. Slice Plane:
  173.      You can selectively remove any bit-plane or combination of
  174.      bit-planes from a picture. Each bit in a plane corresponds
  175.      to one pixel postion. A one bit-plane picture can have
  176.      only two colors because each bit in the plane is either on
  177.      or off. A picture on the Amiga consists of one or more
  178.      layers of these bit-planes. The binary number which is
  179.      extracted from combining bits from each plane determines
  180.      the color used to draw a specific pixel.
  181.  
  182.      With the slicer you can examine each plane or
  183.      combination of bit-planes. With only one plane displayed
  184.      you are essentially seeing the individual bits of memory
  185.      in a single bit-plane. If the bits happen to map to dark
  186.      colors you can brighten the palette by toggling the "False"
  187.      button. This changes the palette to a series of gray levels.
  188.      Press the "View" button if you wish to see the entire
  189.      picture. You can return to the window by pressing the right
  190.      mouse button.
  191.  
  192.      Sometimes you can manufacture interesting effects by
  193.      removing planes from a picture. You can often find smooth
  194.      silhouettes of the features in your pictures.
  195.  
  196. Density Slice:
  197.      You can think of every palette as a series of 
  198.      intensities progressing from no intensity, or black, to
  199.      maximum intensity, or pure white. Whith density slicing,
  200.      you pick a point on this scale of intensities and assign
  201.      one color to one side of the point and another color to
  202.      the other side of the point. You can adjust this point
  203.      with the sliding gadget. The colors will update as you
  204.      move the gadget.
  205.  
  206.      If "Mono" (for monochrome) is selected, the point is
  207.      adjusted with black to the left side and red to the right
  208.      side of the scale all of the colors will shift to black.
  209.      At either end of the scale the screen will turn all one 
  210.      color.
  211.  
  212.      If you lose the gadget, hitting the space bar will
  213.      return the slicing point to the center. Pressing the 'R'
  214.      key will restore the original palette. Also, you can move
  215.      the slicing point left by pressing the '<' key and right
  216.      by pressing the'>' key.
  217.  
  218.      You can slice the scale of intensities at more than
  219.      one point with the two markers. By pressing a marker button
  220.      you will place a numbered marker at the current position of
  221.      the sliding gadget. Butcher will use green to the right
  222.      side of this marker. With one marker and the point above
  223.      the sliding gadget you can slice the palette into three
  224.      levels. With two markers you can slice the palette into
  225.      four levels. Yellow is the fourth color. If you cansider
  226.      the areas between markers, and between markers and end
  227.      points, as regions, you can adjust a slicing point within
  228.      any one of these regions with the sliding gadget. The
  229.      purpose of this scheme is to allow simple adjustment along
  230.      the entire scale even while using multiple levels. This
  231.      becomes important if you choose "View" and close the window
  232.      Butcher will continue to adjust the slicing point by
  233.      responding to the keyboard commands.
  234.  
  235.      If you choose "Color", the darker colors to the left
  236.      side of the slicing point are replaced with black as you
  237.      slide right. The original colors return as you slide the
  238.      gadget to the left. In Color mode, the markers are ignored.
  239.  
  240.      By pressing the "Reverse" button, you can invert and
  241.      redisplay the colors. If the mode is "Color" and you have
  242.      the dark colors of the palette on the right side of the
  243.      scale, white will fill on the left side of the slicing
  244.      point instead of black.
  245.      If you choose "View" the utility window will disappear
  246.      You can still use the keyboard commands. Pressing the
  247.      right mouse button returns the window.
  248.  
  249.      Density slicing is useful for pictures with very low
  250.      contrasts. By dividing regions of intensity into starkly
  251.      different colors, you can highlight various features
  252.      which are not very prominent in the original picture.
  253.      Density slicing only operates on the palette. The program
  254.      does not rewrite any pixels. It is helpful if you copy
  255.      the original palette into one of the other palettes before
  256.      you use density slicing. You can manipulate one of the
  257.      palettes and then alternate the original palette with
  258.      the transformed palette from the menu.
  259.  
  260. Convert Menu
  261. ------------
  262. Histogram and Quick Merge:
  263.      In "Histogram" the program counts the number of
  264.      pixels drawn in each color of the palette. After it
  265.      finishes the count, Butcher displays a bar chart describing
  266.      the relative totals. You can sort the colors by number of 
  267.      pixels, exchange sets of pixels (not colors as in the 
  268.      palette), and merge all or portions of these sets into 
  269.      other colors. Butcher immediately rewrites the pixels
  270.      and updates the graph.
  271.  
  272.      "Quick Merge" is a modified version of "Histogram".
  273.      When "Histogram" first opens, it counts all of the pixels
  274.      in the picture. This takes about ten seconds in low
  275.      resolution. The counting can take much longer in higher
  276.      resolutions. With "Quick Merge", the program samples the
  277.      picture. You do not get the precise counts for each color,
  278.      but you can get to the tools of "Histogram" a lot faster.
  279.     
  280.      The current color is selected at the bottom of the
  281.      window by pressing one of the color gadgets. The RGB
  282.      values are updated in the box to the right. These numbers
  283.      are in hexadecimal so that '0' is the minimum value and
  284.      'f' is the maximum value. For example, white is
  285.      described as 'fff', bright red as 'f00', a medium gray
  286.      might be '777', and black is '000'. You can also select a
  287.      color by choosing "Pick". The window will disappear with
  288.      the current color flashing in varying intensities of red.
  289.      You can stop the flashing by pressing the left mouse 
  290.      button. By pressing the left mouse button over a pixel of
  291.      another color you can select that color as the current
  292.      color. You can return to "Histogram" by pressing the 
  293.      right mouse button. The last flashing color is now the
  294.      current color.
  295.  
  296.      If you press the "Use" button, the pixel count for
  297.      the current color is displayed in the window title bar. Its
  298.      percentage of the total number of counted pixels is also
  299.      displayed.
  300.  
  301.      With "Merge" you can merge all or a clipped section of
  302.      the pixels of a single color into another color. In other 
  303.      words, the pixels of the current color are redrawn using 
  304.      the selected color. You can effectively reduce the number
  305.      of colors in a picture by merging some colors into other
  306.      closely related colors. This can free room for defining
  307.      new colors in the palette or you can reduce the memory
  308.      requirements and the file size of the picture by removing
  309.      enough colors to eliminate a bit-plane.
  310.  
  311.      Sometimes, you can improve the appearance of the 
  312.      picture by merging some of the pixels. For example, a
  313.      digitizer may have generated a blue sky with a mix of 
  314.      various shades of blue. The picture might look better if
  315.      you merge most of the shades of blue into a single shade.
  316.      The fine shadings of buildings or other features remain
  317.      in the picture. By breaking the uniform texture of the
  318.      picture, you can often improve its perceptual depth. You
  319.      can do this with drawing programs but it can become
  320.      tedious if you must draw around or through complicated
  321.      features.
  322.  
  323.      You can clip a rectangle in which all merging
  324.      operations will occur. When you choose "Clip" the window
  325.      disappears, and you can pull rectangles on the screen by
  326.      pushing and releasing the left mouse button. If you don't
  327.      quite like the rectangle you have drawn, you can start over
  328.      and Butcher will remove the preceding rectangle. The final
  329.      rectangle is selected when you push the right mouse button.
  330.      A clip can be removed by pushing the "Clip" button again.
  331.      Clips only apply to the command of merging pixels.
  332.  
  333.      Butcher updates the pixel count after every merging
  334.      or sorting operation. The update is almost instantaneous
  335.      after merging the entire screen. Because the program has to
  336.      count the pixels within a clip, clipped operations take
  337.      more time to finish.
  338.  
  339.      "Blend" performs a full screen merge of pixels. In
  340.      this case, the color into which you are merging may change.
  341.      This change is determined by a proportional change. This
  342.      change is determined by a proportional mix of the two 
  343.      colors based on their relative pixel counts. If the
  344.      second color has many more pixels than the first color, no
  345.      change will occur in the second color.
  346.  
  347.      "Exchange" rewrites the pixels of one color into the
  348.      position of a second color. The pixels of the second color
  349.      are placed in the original position of the first color.
  350.      Since both of the colors are also exchanged, there is no
  351.      change in the picture.
  352.  
  353.      "Sort" rewrites pixels until their counts are in 
  354.      descending order. The sort starts with the third color and 
  355.      proceeds to the last color in the palette. Color Numbers
  356.      One and Two are unaffected. By sorting the colors you can
  357.      place the least significant colors, in terms of their
  358.      pixel counts, at the end of the palette. Sorting is the 
  359.      only operation which cannot be reversed with the "UNDO"
  360.      command.
  361.  
  362. Auto Merge:
  363.      You can define the maximum number of colors used in
  364.      the palette. "Auto Merge" will merge, blend, and sort
  365.      the colors until all of the palette positions beyond the
  366.      maximum count are without pixels. You can redefine the
  367.      empty color registers without changing the picture.
  368.  
  369. Auto Chop:
  370.      "Auto Chop" uses "Auto Merge" to remove enough colors
  371.      from the picture in order to reduce the number of bit-
  372.      planes in the picture. After it completes merging,
  373.      Butcher converts the pcture to a screen with the specified
  374.      number of bit-planes. Suppose you currently have a five
  375.      bit-plane picture. If you specify a depth of four planes,
  376.      Butcher clears the pixels of 16 colors from the picture.
  377.      The picture is changed into a four plane picture with a
  378.      maximum of 16 colors.
  379.  
  380. Change Depth:
  381.      You can change the number of bit-planes in the 
  382.      picture without regard for the information in the dis-
  383.      carded bit-planes. This will usually result in severe and
  384.      not entirely pleasant changes in your picture. If you
  385.      increase the depth of a picture, clear bit-planes are
  386.      added to the picture and the picture appears unchanged.
  387.      Adding one plane will double the number of colors 
  388.      which you can use.
  389.  
  390. Lo-Res to HAM
  391.      This command will convert a low resolution picture
  392.      (320 x 200) of any depth to a Hold and Modify picture.
  393.  
  394. HAM to Lo-Res
  395.      This converts a Hold and Modify picture to a low
  396.      resolution picture. It can hen be used in most paint
  397.      programs. Since Hold and Modify pictures can use all of
  398.      the Amiga's 4,096 colors, the reduction to 32 colors in
  399.      low resolution will almost always result in a picture of
  400.      less quality than the original.
  401.  
  402. Slice Menu
  403. ----------
  404.      The items in the slice menu represent similar operations.
  405.      You can change pictures to different resolutions by expanding
  406.      or reducing their width or height. The depth does not change
  407.      unless you are converting a picture with a width of 320 pixels
  408.      and a depth of five planes into a picture with a width of 640
  409.      pixels. The fifth plane is discarded in the conversion. 
  410.      Before perfomring this command it is important that you
  411.      clear out the last bit-plane with either "Auto Chop" or "Auto
  412.      Merge".
  413.  
  414.      If you are converting a picture to a higher resolution
  415.      it will not look any different after the conversion. Single
  416.      pixels are split into two pixels, but the picture appears no
  417.      different. This is not the case when you change a picture to
  418.      a lower resolution. Every other pixel is lost in the conversion.
  419.